IA Gemini (Google) (Novo)
Liga as respostas por IA da 06.1 - Base de Conhecimento: no quadro Pergunte à IA, a dúvida da equipe é respondida com um resumo dos artigos cadastrados, citando as fontes. A IA usada é o Gemini, do Google.
A integração está em Configurações › Integrações › IA Gemini e faz parte do plano — não há custo adicional na assinatura do EOS. Ela só precisa ser ativada por você.
Requer a permissão "Empresa e parâmetros": com visualizar, a página abre só para consulta; com editar, é possível ligar, cadastrar a chave e testar.
O que você precisa
Uma chave de API do Gemini, gerada no Google AI Studio com a conta Google da sua empresa. A chave é da sua conta: o uso da API segue as condições (cota gratuita ou cobrança) que o Google aplica a essa conta.
Para gerar a chave:
- Acesse aistudio.google.com/apikey com a conta Google da empresa.
- Clique em Criar chave de API (Create API key).
- Copie a chave gerada.
Use uma conta Google da empresa, e não a pessoal de um funcionário: se a pessoa sair, a chave continua com vocês.
Ligando a IA
- Abra Configurações › Integrações e clique no cartão IA Gemini (Google).
- Ligue a chave Recurso ativo.
- Cole a chave no campo Chave da API.
- Clique em Salvar.
- Clique em Testar chave — a resposta "Chave válida. Modelo em uso: ..." confirma que está tudo certo.
Pronto: o quadro Pergunte à IA passa a responder na Base de Conhecimento para todos os usuários do estabelecimento.
Sobre a chave
| Situação | Como funciona |
|---|---|
| Guardada cifrada | A chave é gravada de forma cifrada e nunca é exibida de volta — o campo mostra "(já cadastrada)" |
| Trocar a chave | Cole a nova chave e salve. Ela substitui a anterior e fica aguardando um novo teste |
| Manter a chave | Deixe o campo em branco ao salvar |
| Remover chave | Apaga a chave gravada. A IA para de responder até uma nova chave ser cadastrada |
Conexão
Com a chave cadastrada, o bloco Conexão mostra a situação:
| Situação | O que significa |
|---|---|
| Chave cadastrada, ainda não testada | Salva, mas ainda sem teste ou uso |
| Chave conferida | O teste ou a última pergunta funcionou |
| A última chamada falhou | O motivo aparece em Última falha — veja a tabela abaixo |
Na vitrine de Integrações, o cartão aparece como Desligada, Falta conectar (ligada, sem chave), Conectada ou Com erro.
Mensagens de falha
| Mensagem | O que fazer |
|---|---|
| Chave da API do Gemini inválida | Confira se a chave foi copiada inteira; se preciso, gere outra no Google AI Studio |
| A chave da API não tem acesso ao Gemini | A chave existe, mas a conta não tem a API liberada. Confira no Google AI Studio |
| Limite de uso da sua conta Gemini atingido | A cota da conta Google acabou por agora. Aguarde ou revise o plano da conta no Google |
| O Gemini está indisponível no momento / demorou demais para responder | Instabilidade do serviço do Google. Tente de novo em instantes |
Desligando
Desligue a chave Recurso ativo e salve. O quadro Pergunte à IA deixa de responder; a busca e os artigos continuam funcionando normalmente, e o aviso de material de apoio no chamado e na OS também.
Desligar não apaga a chave: religar volta a funcionar sem cadastrar de novo.
Privacidade
- Para responder, o EOS envia ao Gemini a pergunta e o texto dos artigos encontrados na sua base (até 5 por pergunta). Nenhum dado de cliente, OS ou chamado é enviado.
- Evite colocar nos artigos informações que não deveriam sair da empresa, como senhas de equipamentos de clientes.
- Cada pergunta fica registrada no sistema, com a quantidade de texto processado, para acompanhamento do uso.
Conceitos relacionados
- 06.1 - Base de Conhecimento — onde a IA responde.
- 12.4.1 - Integrações — a vitrine das integrações.
- 12.2 - Assinatura (Meu Plano) — a Base de Conhecimento aparece em Incluído no plano.